Get fulfillment option - Fire spark

{
  "data": {
    "id": "delivery",
    "uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "brand_id": null,
    "merchant_id": "22222222-2222-2222-2222-222222222222",
    "name": "Delivery",
    "type": "DELIVERY",
    "status": "ACTIVE"
  }
}

Returns one fulfillment option by external id. Use this endpoint after the customer selects a fulfillment mode to load its name, type code, and status for the storefront.

Requires a Fire spark access token obtained through token exchange.

Path parameters

Parameter	Required	Description
`id`	Yes	External fulfillment identifier. Alphanumeric characters, `_`, and `-` only. 1–64 characters.

Query parameters

Parameter	Required	Description
`channel_id`	No	External channel identifier. When set, returns 404 unless this fulfillment’s `channel_ids` include the value.

Request

curl "https://firespark.cloud/api/storefront/v1/fulfillment/delivery?channel_id=app" \
  -H "Authorization: Bearer ACCESS_TOKEN"

Response

The response wraps a single fulfillment object in data. The shape matches list fulfillment options.

{
  "data": {
    "id": "delivery",
    "uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "brand_id": null,
    "merchant_id": "22222222-2222-2222-2222-222222222222",
    "name": "Delivery",
    "type": "DELIVERY",
    "status": "ACTIVE"
  }
}

Fulfillment fields

See list fulfillment options for the full schema.

Use the fulfillment type when loading stores and checking which locations expose that mode. Store responses nest operational rules under fulfillment.<type>.

Error responses

Status	Description
`401`	Missing or invalid access token.
`403`	Token does not have access to this fulfillment option.
`404`	No fulfillment option found with the given `id`.